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Foreword 



id , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



The present document is part of a TS-family covering the 3rd Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; Test management Integration Reference Point 
(IRP), as identified below: 

32.321: "Test management Integration Reference Point (IRP); Requirements"; 

32.322: "Test management Integration Reference Point (IRP): Information Service (IS)"; 

32.323: "Test management Integration Reference Point (IRP): Common Object Request Broker 

Architecture (CORBA) Solution Set (SS)"; 

32.324: "Test management Integration Reference Point (IRP): Common Management Information Protocol 

(CMIP) Solution Set (SS)". 

A 3G telecommunication network is composed of a multitude of different Network Elements (NE). For a successful 
operation of the network the operator must be provided with mechanisms allowing him to manage the network. These 
management activities can be grouped into several areas: configuration management, fault management, performance 
management, accounting management and security management. 

A management function assisting in different high level management areas such as fault management and performance 
management is test management. The purpose of testing is to get information about the functionality and performance 
of the 3G managed network subject to the test. 

The present document is part of a TS-family defining defining the Telecommunication Management (TM) of 3G 
systems. The TM principles are described in 3GPP TS 32.101 [5]. The TM architecture is described in 3GPP TS 32.102 
[6]. The other specifications define the interface (Itf-N) between the managing system (manager), which is in general 
the Network Manager (NM) and the managed system (agent), which is either an Element Manager (EM) or the 
managed NE itself. The Itf-N is composed of a number of Integration Reference Points (IRPs) defining the information 
in the agent that is visible for the manager, the operations that the manager may perform on this information and the 
notifications that are sent from the agent to the manager. One of these IRPs is the Test IRP. 

Each IRP is specified by the requirements part, the Information Service part, the CORBA SS and the CMIP SS. 
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Scope 



The present document specifies the CORBA SS for the IRP whose semantics is specified in Test Management IRP IS 
(3GPP TS 32.322 [6]). 

Clause 1 to 3 provides background information. Clause 4 provides key architectural features supporting the SS. 
Clause 5 defines the mapping of operations, notification, parameters and attributes defined in IS to their SS equivalents. 
Clause 6 describes the notification interface containing the push method. Annex A contains the IDL specification. 

This Solution Set specification is related to 3GPP TS 32.322 (V5.1.X). 



References 



The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] Object Management Group 98 (November 1998): "Notification Service: Joint Revised Submission 

OMG TC Document telecom/98- 1 1-01" . http://www.omg.org/technology/documents/ 

[2] OMG CORBA Services (November 1996): "Common Object Services Specification" (clause 4 

contains the Event Service specification), http://www.omg.org/technology/documents/ 

[3] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name 

convention for Managed Objects". 

[4] 3GPP TS 32.302: "Telecommunication management; Configuration Management; Notification 

Integration Reference Point; Information Service version 1". 

[5] 3GPP TS 32.303: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Common Object Request Broker Architecture 
(CORBA) Solution Set (SS)". 

[6] 3GPP TS 32.322: "Telecommunication management; Test management Integration Reference 

Point (IRP): Information Service (IS)". 

[7] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Information Service (IS)". 

[8] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions defined in 3GPP TS 32.322 [6] apply. 
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3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CMIP Common Management Information Protocol 

CORBA Common Object Request Broker Architecture 

EM Element Manager 

GSM Global System for Mobile communications 

IDL Interface Definition Language 

IRP Integration Reference Point 

IOC Information Object Class 

IS Information Service 

NE Network Element 

NM Network Manager 

OMG Object Management Group 

QoS Quality of Service 

SS Solution Set 

3.3 IRP document version number string 

The IRP document version number (sometimes called "IRP version" or "version number") string is used to identify the 
present document. The definition of "IRP document version number string" in 3GPP TS 32.31 1 [8] provides the rule to 
derive such a string. 

This string is returned in get_test_management_IRP_versions method and is carried in the first field of the 
notification header of all notifications related to Test Management IRP. This string is also returned in 
get_notif ication_categories method of the Notification IRP Agent, in case that IRP Agent is responsible for 
emitting notifications related to Test Management IRP. 



4 Architectural features 

The overall architectural feature of Test Management IRP is specified in 3GPP TS 32.322 [6], The present document 
specifies features that are specific to the CORBA SS. 

4.1 Notification Services 

In implementations of CORBA SS, IRP Agent conveys Test Management information to IRPManager via OMG 
Notification Service (OMG Notification Service [1]). 

OMG Event Service [2] provides event routing and distribution capabilities. OMG Notification Service provides, in 
addition to Event Service, event filtering and Quality of Service (QoS) as well. 

A necessary and sufficient sub set of OMG Notification Services shall be used to support 
TestManagementlRPNotif ications notifications as specified in 3GPP TS 32.322 [6]. 



4.2 Push and Pull Style 



OMG Notification Service defines two styles of interaction. One is called push style. In this style, IRP Agent pushes 
notifications to IRPManager as soon as they are available. The other is called pull style. In this style, IRP Agent keeps 
the notifications till IRPManager requests for them. 

The Notification CORBA SS in 3GPP TS 32.303 [5] specifies that support of Push style is Mandatory (M) and that 
support of Pull style is Optional (O). 
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4.3 Support multiple notifications in one push operation 

For efficiency reasons, IRP Agent may send multiple notifications using one single push operation. To pack multiple 
notifications into one push operation, IRP Agent may wait and not invoke the push operation as soon as notifications 
are available. To avoid IRP Agent to wait for an extended period of time that is objectionable to IRPManager, IRP Agent 
shall implement an IRP Agent wide timer configurable by administrator. On expiration of this timer, IRP Agent shall 
invoke push if there is at least one notification to be conveyed to IRPManager. This timer is re-started after each push 
invocation. 



5 Mapping 

5.1 Operation and Notification mapping 

The Test Management IRP IS in 3GPP TS 32.322 [6] defines semantics of operation and notification visible across the 
Test Management IRP. Table 1 indicates mapping of these operations and notifications to their equivalents defined in 
the present SS. 

Table 1 : Mapping from IS Operations and Notification to SS equivalents 



IS Operations/ notification TS 32.322 [6] 


SS Method 


Qualifier 


initiateTests 


initiate tests 


M 


terminateTests 


terminate tests 


M 


monitorTest 


monitor test 


M 


getlRPVersion 


get test management IRP versions 


M 


getOperationProfile (see note) 


get test management IRP operation profile 


O 


getNotificationProfile (see note) 


get test management IRP notification profile 


O 


notify TestResu It 


push structured event (See subclause 6.1) 


M 


NOTE: This operation is of ManagedGenericIRP IOC specified in 3GPP TS 32.312 [7]. 
The TestManagementIRP IOC of [6] inherits from it. 



5.2 Operation parameter mapping 



The Test Management IRP IS in 3GPP TS 32.322 [6] defines semantics of parameters carried in operations across the 
Test Management IRP. Table2 gives the mapping of these parameters, as per operation, to their equivalents defined in 
this SS. 

Table 2: Mapping from IS initiateTests parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


testlnvocationlnitiator 


TestManagementlRPConstDefs::Testlnvocationlnitiator 
test invocation initiator 


M 


maxTestingStateDuration 


long maxtestingStateDuration 


M 


toBelnitiatedTests 


TestManagementlRPConstDefs::ToBelnitiatedTestSeq 
to be initiated test seq 


M 


response 


TestManagementlRPConstDefs::lnitiateTestsResponse 

Exceptions: 
InitiateTests, 

ManagedGenericlRPSystem::ParameterNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 
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Table 3: Mapping from IS terminateTests parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


toBeTerminatedTests 


TestManagementlRPConstDefs::ToBeTerminatedTestSeq 
to be terminated test seq 


M 


response 


TestManagementlRPConstDefs::TerminateTestsResponse 

Exceptions: 

TerminateTests, 

ManagedGenericlRPSystem::OperationNotSupported, 
ManagedGenericlRPSystem::ParameterNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 



Table 4: Mapping from IS monitorTest parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


toBeMonitoredTO 


TestManagementlRPConstDefs::ToBeMonitoredTO 
to be monitored TO 


M 


attributeList 


TestManagementlRPConstDefs::TOAttributeListtO attribute list 


M 


error 


ManagedGenericlRPConstDefs::Signal 

Exceptions: 
MonitorTest, 

ManagedGenericlRPSystem::OperationNotSupported, 
ManagedGenericlRPSystem::ParameterNotSupported, 
ManagedGenericlRPSystem::lnvalidParameter 


M 



5.3 Notification parameter mapping 



The Test Management IRP IS in 3GPP TS 32.322 [6] defines semantics of parameters carried in notifications. The 
following table indicates the mapping of these parameters to their OMG CORBA Structured Event (defined in OMG 
Notification Service [1]) equivalents. The composition of OMG Structured Event, as defined in the OMG Notification 
Service [1], is: 



Header 



3ody 



Fixed Header 

domain_name 

type_name 

event_name 
Variable Header 

f i Iter able_body_fie Ids 
remaining_body 
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Table 5 lists all OMG Structured Event attributes in the second column. The first column identifies the Test 
Management: IS 3GPP TS 32.322 [6] defined notification parameters. 

Table 5: Mapping for notifyTestResult 



IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


Comment 


There is no corresponding 
IS attribute. 


domain_name 


M 


It carries the IRP document version number string. See 
subclause 3.3. 

It indicates the syntax and semantics of the Structured Event as 
defined by the present document. 


notificationType 


Type_name 


M 


This is the NOTIFY_TM_TEST_RESULT of module of 
TestManagementlRPConstDefs. 


There is no corresponding 
IS attribute 


event_name 


M 


It carries no information. 


There is no corresponding 
IS attribute. 


Variable Header 






objectClass, 
objectlnstance 


One NV pair of 

filterable_ 

body_fields 


M 


NV stands for name-value pair. Order arrangement of NV pairs is 
not significant. The name of NV-pair is always encoded in string. 

Name of this NV pair is the MANAGED_OBJECT_INSTANCE of 
interface AttributeNameValue of module 
Notification I RPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS [5]. 


notificationld 


One NV pair of 

filterable_ 

body_fields 


M 


Name of NV pair is the NOTIFICATIONJD of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a long. See corresponding table in Notification 
IRP: CORBA SS [5]. 


eventTime 


One NV pair of 

filterable_ 

body_fields 


M 


Name of NV pair is the EVENT_TIME of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS [5]. 


system DN 


One NV pair of 

filterable_ 

body_fields 


M 


Name of NV pair is the SYSTEM_DN of interface 
AttributeNameValue of module NotificationlRPConstDefs. 

Value of NV pair is a string. See corresponding table in 
Notification IRP: CORBA SS [5]. 


testlnvocationlnitiator 


One NV pair of 

filterable_ 

body_fields 


M 


Name of NV pair is the TESTJNVOCATIONJNITIATOR of 
module TestManagementlRPConstDefs. 

Value of NV pair is a string. 


testlnvocationld 


One NV pair of 

filterable_ 

body_fields 


M 


Name of NV pair is the TESTJNVOCATIONJD of module 
TestManagementlRPConstDefs. 

Value of NV pair is a string. 


testActualStartTime 


One NV pair of 

filterable_ 

body_fields 


O 


Name of NV pair is the TEST_ACTUAL_START_TIME of module 
TestManagementlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS [5]. 


testActualStopTime 


One NV pair of 

filterable_ 

body_fields 


O 


Name of NV pair is the TEST_ACTUAL_STOP_TIME of module 
TestManagementlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS [5]. 


testOutcome 


One NV pair of 

filterable_ 

body_fields 


O 


Name of NV pair is the TEST_OUTCOME of module 
TestManagementlRPConstDefs. 

Value of NV pair is the enum TestOutcomeType of 
TestManagementlRPConstDefs. 
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IS Parameters 


OMG CORBA 

Structured 
Event attribute 


Qualifier 


Comment 


mORT 


One NV pair of 

filterable_ 

body_fields 


O 


Name of NV pair is the MORT of module 
TestManagementlRPConstDefs. 

Value of NV pair is a string. 


proposedRepairActions 


One NV pair of 

filterable_body_f 

ields 


O 


Name of NV pair is the PROPOSED_REPAIR_ACTIONS of 
module TestManagementlRPConstDefs. 

Value of NV pair is a string. 


additionallnformation 


Two NV pair of 

filterable^ 

body_fields 





Name of one NV pair is the TEST_ADDITIONAL_INFORMATION 
of module TestManagementlRPConstDefs. 

Value of NV pair is a string. 


fileReference 


One NV pair of 

filterable_ 

body_fields 





Name of NV pair is FILE_REFERENCE of module 
TestManagementlRPConstDefs. 

Value of NV pair is a string. 


fileExpiryDate 


One NV pair of 

filterable_ 

body_fields 





Name of NV pair is the FILE_EXPIRY_DATE of module 
TestManagementlRPConstDefs. 

Value of NV pair is IRPTime. See corresponding table in 
Notification IRP: CORBA SS [5]. 


There is no corresponding 
IS attribute. 


remaining_body 
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6 TestManagementlRPNotification Interface 

OMG CORBA Notification push operation is used to realise the notification of 

TestManagementlRPNotif ications. All the notifications in this interface are implemented using this 
push_structured_event method. 



6.1 Method push (M) 



module CosNotifyComm { 

Interface SequencePushConsumer : NotifyPublish { 
void push_structured_events ( 

in CosNotif ication : : EventBatch notifications) 
raises { CosEventComm: :Disconnected) ; 

}; // SequencePushConsumer 

}; // CosNotifyComm 

NOTE 1: The push_structured_events method takes an input parameter of type EventBatch as defined 
in the OMG CosNotif ication module (OMG Notification Service [1]). This data type is the same as 
a sequence of Structured Events. Upon invocation, this parameter will contain a sequence of Structured 
Events being delivered to IRPManager by IRP Agent to which it is connected. 

NOTE 2: The maximum number of events that will be transmitted within a single invocation of this operation is 
controlled by IRP Agent wide configuration parameter. 

NOTE 3: The amount of time the supplier (IRP Agent) of a sequence of Structured Events will accumulate 
individual events into the sequence before invoking this operation is controlled by IRP Agent wide 
configuration parameter as well. 

NOTE 4: IRP Agent may push EventBatch with only one Structured Event. 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name 

"TestManagementlRPConstDefs.idl") 

#ifndef TestManagementlRPConstDef s_idl 
#def ine TestManagementlRPConstDef s_idl 

#include "CosNotif ication. idl" 

#include "ManagedGenericIRPConstDef s . idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: TestManagement IRPConstDef s 

This module contains commonly used definitions for Test Management IRP 

*/ 

module TestManagementlRPConstDef s 
{ 

/* 

This defines the notification type of this Test Management 
IRP. 

*/ 

const string NOTIFY_TM_TEST_RESULT = "xl"; 

/* 

This enum defines the test state 

*/ 

enum TestStateType { 

Notlnitialized, 

Idle, 

Initializing, 

Testing, 

Terminating, 

Disabled 
}; 

/* 

This enum defines the test outcome 

*/ 

enum TestOutcomeType { 

Inconclusive, 

Pass, 

Fail, 

TimeOut, 

PrematureTermination 



/* 

This block defines notification attributes of this IRP. 
These attribute values should not clash with those used 
in Notification header (see IDL of Notification IRP) 
*/ 

const string TEST_INVOCATION_INITIATOR = "f"; 
const string TEST_INVOCATION_ID = "g"; 
const string TEST_ACTUAL_START_TIME = "h"; 
const string TEST_ACTUAL_STOP_TIME = "i"; 
const string TEST_0UTC0ME = "j"; 
const string MORT = "k"; 

const string PROPOSED_REPAIR_ACTIONS = "1"; 
const string ADDITIONAL_INFORMATION = "m"; 
const string FILE_REFERENCE = "n"; 
const string FILE_EXPIRY_DATE = "o"; 
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typedef string Testlnvocationlnitiator; 
typedef string ToBeMonitoredTO; 

typedef CosNotif ication: :PropertySeq NVPairs; 

/* 

Define a seq of to-be-initiated-test 

*/ 

struct ToBelnitiatedTest 

{ 

unsigned long max_testing_state_duration; //seconds; 0->no limit 

string toBeTestedMORT; //MORT DN 

string tOClass; //Tester object class 

string tODN; //Tester object DN 

NVPairs tONVPair; //Tester object attributes in NV pairs 

}; 

typedef sequence <ToBeInitiatedTest> ToBelnitiatedTestSeq; 

/* 

Define the structure returned by initiate_tests 

*/ 

struct InitiateTestsResponseElement 

{ 

// If failureReason is NULL, the test is initiated successfully and 

// test Invocationld contains the invocation id. In case the tester object name is not 

// provided in the request, it shall be carried by testerOb jectDN. In case the tester 

// object name is provided in the request tODN shall be NULL. 

// Else, the test initiation fails and failureReason contains 

// the failure reason and testlnvocationld contains garbage. 

string failureReason; 

string testlnvocationld; 

string tODN; 

}; 

typedef sequence <InitiateTestsResponseElement> InitiateTestsResponse; 



/* 

Define a seq of to-be-terminated-test 

*/ 

typedef string Testlnvocationld; 

typedef sequence <TestInvocationId> ToBeTerminatedTestSeq; 

/* 

Define the structure returned by terminate_tests 

*/ 

struct TerminateTestsResponseElement 

{ 

// If failureReason is NULL, the test has terminated successfully and 
// testlnvocationld identifies the terminated invocation. 
// Else, the test termination fails and failureReason contains 
// the failure reason and testlnvocationld contains garbage, 
string failureReason; 
string testlnvocationld; 

}; 

typedef sequence <TerminateTestsResponseElement> TerminateTestsResponse; 

/* 

Define the structure of a TOAttributes . 

*/ 

struct TOAttributes 

{ 

TestStateType testState; 

TestOutcomeType testOutcome; 

NVPairs attributesInNVPairs; 



#endif 
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A.2 IDL specification (file name 

"TestManagementlRPSystem.icH") 

tifndef TestManagementIRPSystem_idl 
#def ine TestManagement IRPSystem_idl 

#include "TestManagementlRPConstDef s . idl" 
#include "ManagedGenericIRPSystem. idl" 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

/* ## Module: TestManagementlRPSystem 

This module contains the specification of all methods of TestManagement IRP Agent. 



*/ 

module TestManagementlRPSystem 
{ 

/* 

System may fail to complete an operation. System can provide reason 

to qualify the failed reason. The semantics carried in reason 

is outside the scope of this IRP. 

*/ 

exception GetTestManagementlRPVersions { string reason; }; 

exception GetTestManagementlRPOperationsProf ile { string reason; }; 

exception GetTestManagementlRPNotif icationProf ile { string reason; }; 

exception InitiateTests { string reason; }; 

exception TerminateTests { string reason; }; 

exception MonitorTest { string reason; }; 



interface TestManagementIRP 
{ 

/* 

Return the list of all supported TestManagement IRP versions. 

*/ 

ManagedGenericIRPConstDef s : : Vers ionNumber Set 

get_Test_Management_IRP_versions ( 



raises (GetTestManagementlRPVersions) ; 



/* 

Return the list of all supported operations and their supported 

parameters for a specific TestManagement IRP version. 

*/ 

ManagedGenericIRPConstDef s : :MethodList 

get_Test_Management_IRP_operations_prof ile { 

in ManagedGenericIRPConstDef s : : VersionNumber 
test_management_irp_version 

) 

raises {Get Test Management IRPOpe rationsP r of ile, 

ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Return the list of all supported notifications and their supported 

parameters for a specific TestManagement IRP version. 

*/ 

ManagedGenericIRPConstDef s : :MethodList 

get_Test_Management_IRP_notif ication_prof ile ( 
in ManagedGenericIRPConstDef s : : VersionNumber 
test__management_irp__version 

) 

raises {GetTestManagementlRPNotif icationProf ile, 

ManagedGenericIRPSystem: : OperationNotSupported, 
ManagedGenericIRPSystem: : InvalidParameter) ; 
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/* 

Request to initiate tests. 

*/ 

TestManagement IRPConstDef s : : InitiateTestsResponse 

initiate_tests ( 

in TestManagement IRPConstDef s : : Testlnvocationlnitiator 

test_invocation_initiator, 
in TestManagementlRPConstDefs : : ToBelnitiatedTestSeq 
to_be_initiated_test_seq 
) 
raises (InitiateTests, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Request to terminate tests. 

*/ 

TestManagementlRPConstDefs : : TerminateTestsResponse 

terminate_tests ( 

in TestManagementlRPConstDefs: : ToBeTerminatedTestSeq 
to_be_terminated_test_seq 
) 
raises (TerminateTests, 

ManagedGenericIRPSystem: : InvalidParameter) ; 

/* 

Request test info (to monitor a test) . 

*/ 

ManagedGenericIRPConstDef s : : Signal monitor_test ( 

in TestManagementlRPConstDefs: : ToBeMonitoredTO 
to„be_monitored_TO, 

out TestManagementlRPConstDefs : : TOAttributes tO_attributes 
) 
raises (MonitorTest, 

ManagedGenericIRPSystem: : InvalidParameter) ; 



#endif 
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